Ian & Stuart's Australian Mac: Not for Sale/Another.not.for.sale (Australia).iso/fade into you/being there/How To & FAQ's/Veronica-FAQ

Text File | 1994-03-22 | 22KB | 531 lines

Common Questions and Answers about veronica, a title search and retrieval
system for use with the Internet Gopher.

The current version of this FAQ can be retrieved through gopher at
veronica.scs.unr.edu, in the veronica directory.
FAQ by Steven Foster and Fred Barrie .

Archive-name: veronica-faq
Last-modified:  1993/08/23.
--------------------------------------------------------------------------

List of questions in the veronica FAQ:

Q1: What is veronica?
Q2: How can I connect to veronica?
Q3: So I get a list of titles; How can I get information about the location
    of items I am interested in?
Q4: Why do I need to use 'item descriptor' to get context and host info?
Q5: How can I get my server into the veronica database?
Q6: How can I keep my server out of the veronica database?
Q7: How often is the database updated?
Q8: Where can I get the software to run veronica?
Q9: Where can I get the veronica dataset?
Q10: Why can't I get a reply from a veronica server?
Q11: What does "veronica" mean?
Q12: Why doesn't my server show up in veronica searches?
Q13: Where are the veronica server sites?
Q14: How do I compose veronica search queries and use the veronica options?


--------------------------------------------------------------------------
Q1:        What is veronica?

A1:    veronica is a service that maintains an index of titles of
    gopher items, and provides keyword searches of those titles.
    A veronica search originates with a user's request for a search,
    submitted via a gopher client.  The result of a veronica search is
    a set of gopher-type data items, which is returned to the gopher
    client in the form of a gopher menu.  The user can access
    any of the resultant data items by selecting from the returned menu.

    A veronica search typically searches the menus of hundreds
    of gopher servers, perhaps all the gopher servers that are announced
    to the Internet.

    At present, there are no "veronica clients" per se;  veronica is
    accessed through normal gopher clients.   veronica is tightly
    integrated with the gopher protocol.

    The veronica service comprises two functions:
    1). Harvesting menu data from gopher servers, and preparing it for use;
    2). Offering searches of that database to gopher clients.
    These two functions are not necessarily provided by the same host
    computer.  Most users and administrators of veronica search servers
    will not need to be concerned with the first phase of the process.
    Operators of veronica query-engines can obtain a prepared dataset
    for use with the query server ( Q9 below ).

    veronica evolved as a solution to the problem of resource discovery
    in the rapidly-expanding gopher meta-burrow.  At the University of
    Nevada, there was an outcry for an easy way to find gopher-based
    information without doing a menu-by-menu, site-by-site search.

--------------------------------------------------------------------------
Q2:    How can I connect to veronica?

A2:    veronica must be accessed through a gopher client.
    Assuming you have a gopher client, use it to connect to a gopher
    server which offers a link to a veronica server.

    If your local gopher server does not already have a link to veronica,
    use gopher to go to the server at gopher.micro.umn.edu ( port 70 ).
    Choose the menu item "Other Gopher and Information Servers".
    Choose veronica from that menu.  In step-by-step form it is like this:

    1. gopher to gopher.micro.umn.edu  by typing:
        gopher gopher.micro.umn.edu 70
       Note that this is a unix-client example. Other clients will
       have a different way of specifying the server.

    2.  go to the directory named
        "8.  Other Gopher and Information Servers/"

    3.  select that item

    4.  go to the item named
        "2.  Search titles in Gopherspace using veronica/"

    5.  select that item.  This item is a gopher link to the veronica
        directory at the University of Nevada.

    6.  There are several searches and documents in this directory.
        Help files and announcements and will be posted here.
        This menu contains links to all the announced veronica servers.
        Choose any server by clicking on its entry;  if it give the
        message "Too many connections" or "Cannot connect", you can
        try one of the other servers.

    When you choose a search item, you will be prompted to
    enter a keyword or keywords to define your title search.
    The simplest way to search with veronica is to enter a single
    word and hit the RETURN key.  It does not matter whether the
    word is upper-case or lower-case.  For details on how to
    compose more complex veronica queries, see Q14 in this FAQ,
    "How do I compose a veronica search query".

    The veronica server will return a gopher menu composed of items
    whose titles match your keyword specification.  These items are
    culled from the menus of (potentially) many gopher servers.
    As with any gopher menu, you access an item of interest by
    double-clicking it or hitting the <return> key.

    If you want to include veronica service on the menu of your local
    gopher server,  you can find the gopher-item-descriptor for veronica
    from this menu at Minnesota;  ask the administrator of your local
    gopher server to include a link to that item on your local menu.


    If you DO NOT have a gopher client, you may access gopher and
    veronica by telneting to one of the telnet-accessible anonymous
    gopher clients.  This is what the Gopher-FAQ has to say about the
    telnet sites for gopher:

    ***
    Here is a short list, use the site closest to you to minimize
         network lag.

     Hostname                  IP#              Login   Area
     ------------------------- ---------------  ------  -------------
     consultant.micro.umn.edu  134.84.132.4     gopher  North America
     gopher.uiuc.edu           128.174.33.160   gopher  North America
     panda.uiowa.edu           128.255.40.201   panda   North America
     info.anu.edu.au           150.203.84.20    info    Australia
     gopher.chalmers.se        129.16.221.40    gopher  Sweden
     gopher.ebone.net                gopher  Europe

     It is recommended that you run the client software instead of
     logging into the public telnet login sites.  A client uses the
     custom features of the local machine (mouse, scroll bars, etc.)  A
     local client is also faster.

--------------------------------------------------------------------------
Q3:     So I get a list of titles; How can I get information about
    the location of items I am interested in?

A3:    Most gopher clients offer a "get information" command or an
    "item descriptor" menu choice.  On a macintosh it usually is
    "command i"; on a unix curses client it will be an equal sign "=";
    on a NeXT it also is a "command i".  On the PC gopher clients,
    choose "item inspector" from the "FILE" menu.
    This key sequence will give information about the current item
    on the gopher menu.  The item-description will include the hostname
    of the gopher server which provides the item.  The item-description
    also includes the path (directory) of the item on its gopher server.


--------------------------------------------------------------------------
Q4:    Why do I need to use "item descriptor" to get host and context
    information?

A4:    One simple answer to this is that three-times as many lines
    would be needed on the screen to provide host and path information
    as well as title information.  The menus returned by veronica are
    often lengthy, even without this information.  Since the item-
    description function is included in most gopher clients, its use
    makes for more compact screens.

    There is a deeper answer, of course ...

    The veronica server is designed to work with the query-type item
    of all gopher clients.  It can only return one set of data
    in reply to each query, in accord with the gopher protocol.  There
    is no chance for further negotiation between the client and server.
    The veronica-search server could return visible lines about the
    host and context of each item, but it would need to do so for all
    items, tripling the size of the return as mentioned above.  The
    only alternative is to design special gopher CLIENTS which  either
    submit a follow-up query to the veronica server, requesting more
    information, or which present the item-descriptor in more palatable
    format.   Work is underway to define a client-server negotiation
    protocol to allow followup queries, using the gopher+ clients and
    servers.  Meanwhile, clients just are not capable of this feature.

    And deeper yet ...

    Context means many things ...  Is it adequate to know the host, path
    and type of an item, or do you want to know the last update time,
    the number of links to that item in the entire gopher network,
    a unique internet-id for that data item, the names of veronica servers
    referencing that item, and so forth?  The gopher+ protocol and other
    emerging protocols will allow us to maintain some of this information.
    The veronica developers at Nevada feel that it is preferable to use
    these standards as they become available, rather than to define
    ad-hoc document identifiers, etc. which are specific only to veronica.

--------------------------------------------------------------------------
Q5:    How can I get my server into the veronica database?

A5:    Explicit registration is generally not required.  The veronica
    data-collection software will find your gopher server IF it is
    registered with the Mother Gopher at Minnesota, OR IF it is
    referenced on the menu of another gopher server which is registered
    at Minnesota.  Of course, the veronica data-harvesting algorithm
    will not be able to access your server if you have restricted access
    to your local site.

-----------------------------------------------------------------------------
Q6:    How can I keep my server OUT of the veronica database?

A6:    Sometimes gopher-administrators do not want their site to be
    indexed. The administrator of such a server will need to mail to
    [e-mail], and request their site not be included.

    This design is based on the well-founded assumption that any
    registered gopher server, or a server accessible via the menu of
    a registered server, is intended to be accessible to users at any
    internet node.  The gopher protocol achieves its utility through
    this sort of sharing; gopher servers are provided with the "-s"
    option should it be necessary to implement site restrictions.

    With the implementation of Gopher+ protocols, the veronica+
    protocol will allow gopher administrators to set a
    "veronica-index-off" flag.

    As an interim solution a gopher administrator can create a file named
    "no-index" (without the quotes) so that all sub level menus beneath that
    directory will not be indexed.  This solution should work for all gopher
    servers.  Gopher administrators can use gopher servers ability to mask
    gopher titles from .link or .cap files.  An example of this is:

    In .link format:
        Name=Really cool title like "About this Gopher"
        Path=./no-index

     In a file in the .cap subdirectory named no-index
        Name=Really cool title like "About this Gopher"
--------------------------------------------------------------------------
Q7:    How often is the database updated?

A7:    Every week or (at worst) two weeks.

--------------------------------------------------------------------------
Q8:    Where can I get the software to run veronica?

A8:    The veronica server software can be obtained
    by anonymous ftp from veronica.scs.unr.edu.
    The veronica server code is in the directory "veronica-code".

    The current version ( June 24 ) of the veronica server is 0.5
    It runs on most flavors of unix boxes, requires a perl interpreter
    and dbm, and about 360 MB for the dataset.  (data of June 21 '93)
    The server host should also have a good deal of swap space.


--------------------------------------------------------------------------
Q9:    Where can I get the veronica data set?

A9:    You can anonymous-ftp the full veronica dataset from
    veronica.scs.unr.edu, in the "veronica-data" subdirectory.

    This data has been processed to eliminate redundant references,
    to avoid loops in the gopher network, and to remove most data
    that is known to be highly transient.

    If you are trying to set up a veronica server, PLEASE take a
    copy of this data, rather than initiating more gopher-tree
    processes.

---------------------------------------------------------------------------
Q10:    Why can't I get a reply from a veronica server?

A10:    Sometimes one of the veronica servers is down, or is unreachable
    because of network trouble.  In that case, try another server.

    Another common problem is that the gopher client "hangs" because
    the  results of the veronica search includes items of some type
    not recognized by the client.

    For example, a search will commence and there is some indication
    that it is working, like a spinning wheel on a Mac or on a Unix client.
    However, when the wheel stops spinning the Gopher client says
    "Nothing  available".

    The problem is that some gopher clients can not handle certain objects
    (e.g., a PC client is unable to understand a Unix sound file).
    Many clients are written to treat as empty any directories containing
    non-standard or unrecognized datatypes.

    The solution will be in the Gopher+ protocol.   That protocol
    will allow a client and server to have a "conversation" about
    what types of data the client can and cannot handle.

---------------------------------------------------------------------------
Q11:    What does "veronica" mean?

A11:    very easy rodent-oriented net-wide index to computerized archives.

---------------------------------------------------------------------------
Q12:    Why doesn't my server show up in veronica searches?

A12:    Most commonly this is because your server was not accessible during
    the time we last collected data.

    Be sure your server is registered with the Mother of Gophers, or is
    referenced on the menu of a server which IS registered.  Be sure you
    have not restricted off-site access.

    If these don't work, send mail to [e-mail]
------------------------------------------------------------------------------
Q13:    Where are the veronica server sites?

A13:    There are currently ( June 24, 1993 ) four publicly-accessible
    veronica servers.  All of them can be accessed via the
    veronica Gopher menu at veronica.scs.unr.edu.  If that server
    is down, try one of the other sites below which has a gopher
    menu advertising veronica searches.

    1.    UNR  ( Nevada, USA )
        for a gopher menu of veronica items, gopher to:
            Host=veronica.scs.unr.edu
            Port=70
            Path=1/veronica

    2.    CNIDR  ( North Carolina, USA )
        for a gopher menu of veronica items, gopher to:
            Host=wisteria.cnidr.org
            Port=70
            Path=

        or to search, point your gopher at:
            Name=Search Gopherspace by veronica
            Host=wisteria.cnidr.org
            Type=7
            Port=2347
            Path=

    3.    NYSERNET  ( New York, USA )
        for a gopher menu of veronica items, gopher to:
            Host=nysernet.org
            Port=70
            Path=1/Search the Internet

        or to search, point your gopher at:
            Name=Search Gopherspace by veronica
            Host=nysernet.org
            Type=7
            Port=2347
            Path=

    4.    SERRA  ( Pisa, Italy )
        for a gopher menu with a veronica item, gopher to:
            Host=gopher.unipi.it
            Port=70
            Path=1/University of Pisa - Services

        or to search, point your gopher at:
            Name=Search Gopherspace by veronica
            Host=serra.unipi.it
            Type=7
            Port=2347
            Path=

---------------------------------------------------------------------------
Q14:    How do I compose veronica search queries, and use various
    veronica options?

A14:    The simplest veronica search is just a single word, followed by
    a RETURN.  The following answer is from the document
    "How to compose veronica queries", and was current on June 24, 1993.


 HOW TO COMPOSE VERONICA QUERIES -   version 0.5     June 24, 1993

 New in veronica 0.5
 * server is faster.
 * no changes to user interface.

 New features  in veronica 0.4
 * Support for keyword "NOT".
 * Support for infix queries (i.e. parenthesis).
 * Limited word stemming ( trailing wildcard ).
 * -l option returns link info as a file.
     NOTE that the link option may not work on all veronica servers.
 * -mX  option sets maximum number number of returned items to X.
     IMPORTANT NOTE!  Number of returned items is now LIMITED to 200
     UNLESS you specify this option.
     "-m" option without a numeric parameter sets unlimited
     number of return items.

 New features in veronica 0.3
 * Support for "-t" flag:  specify gopher item-types.

 New features in veronica 0.2
 * Support for keywords "AND" and "OR"

 ***
 ***  QUERY KEYWORD LOGIC
 The search understands the logical operators AND, NOT, OR, (, and ).
 Adjacent keywords without an intervening logical operator are treated as
 though conjoined by an AND.

 Interpretation of the query starts from the right-hand, interpreting operators
 as encountered.  If in doubt about order of interpretation, USE PARENTHESES!

 Search keywords are NOT case-sensitive.

 ***  RESTRICTING  THE SEARCH TO CERTAIN GOPHER TYPES
 You can limit the data returned by veronica to certain gopher item types.
 This restriction is done by adding a -t type specifier to your query.
 The -t flag may appear anywhere in the search specification.  For instance:
    "women -t1" returns links to gopher DIRECTORIES whose name contains "women".
    "-t1 women"  does exactly the same thing.
 NOTE that there must NOT be any spaces between the -t and the type specifier.

 You may specify MORE THAN ONE type in the query.  DO NOT use separate -t
 specifications to do this; simply put all the types together (with no
 spaces) after the -t.  For example:
    "-ts1  mac"  returns links to gopher DIRECTORIES or SOUNDS with the word
             "mac" in the name.
    "women -t18"  returns links to gopher DIRECTORIES or TELNET links, whose
         name contains the word "women".

 Official gopher types, from the Gopher Protocol Document, are:

 0    item is a file
 1    item is a directory
 2.    item is a CSO (qi) phonebook server
 3    ERROR
 4    item is a BinHexed Mac file (discouraged)
 5    item is a DOS binary archive of some kind (discouraged)
 6    item is a Unix uuencoded file (discouraged)
 7    item is an Index-Search server
 8    item is a pointer to a telnet session
 9    item is a binary file of some sort
 +    redundant server ( same a previous server )

 *** USING THE OPTIONS
    Just include the options in the search query.  They will work
    with any gopher client.  You can put options before the query words,
    after the query words, or even between query words.

     DO NOT cluster more than one option behind a single hyphen; instead,
     use a separate hyphen for each separate option.  For example:

         gopher -t1s -l -m400

     This example requests 400 items containing the word "gopher", and
     specifies that we want only items whose type is "directory" or
     "sound", and that we want a link-file containing the results.

 ***  EXAMPLES:

 Simple examples:

     Search on the keyword "internet".  This will return a menu list of
     (at most) 200 records that have the word internet in the title field.
     Just type-
             internet

     Search on the keyword "internet", but specify 1000 items instead of
     the default 200.
     type-
             internet -m1000
         or
             -m1000 internet

     Search on the keywords "chicken" and "wine".  This returns a menu
     list of (at most) 200 records that have _BOTH_ "chicken" and "wine".
     Type-
             chicken and wine

     Search for the keywords "chicken" or "wine", specifying directories only.
     This returns a menu list of records that have _EITHER_ chicken or wine,
     and which are GOPHER DIRECTORY entries.  Type-

             chicken or wine -t1
     or
             -t1 chicken or wine


 Examples for the operator "NOT":

     To use the operator "NOT" in a query:


             chicken not wine    (will search for all titles with the
                                  word chicken _BUT NOT_ the word
                                  wine)

             chinese food not msg     (will search for our health nuts
                                      all the titles with the words
                                      chinese _AND_ food _BUT NOT_
                                      msg.  Remember there is an
                                      implied _AND_ between two words)

 Examples for infix queries:

     The parentheses allow more complicated searches that were
     not available in previous versions of the perl veronica server.

             examples:

             chicken (wine or curry)  -m      (will list ALL titles with the
                                              words chicken _AND_ either
                                              wine _OR_ curry.  -m asks
                         for ALL records.)

             (chicken or wine) not (msg or growing)
                                     (will search for titles with the
                                      words chicken _OR_ wine _BUT NOT_
                                      msg _OR_ growing)

 Examples for word stemming

     The metacharacter "*" matches anything at the TRAILING END of a
     search word.

             chicken*            (will search for all titles with the
                                  word chicken, chickens, ...)

             chicken* or wine*    (will search for all titles with the
                                  word chicken, chickens, ... _OR_
                                  wine, wines, wineries, ...)

             (chicke* or wine*) not (msg* or growing* and good*)
                                 (this query results are left to the
                                  curious)